[GW-002] Создать Метод POST /api/v1/purchase/upload-receipt

Реализация внедоменного эндпоинта загрузки графических файлов

Author

Services Task & Simulation Framework Documentation

Published

July 13, 2026

NoteКраткая карточка задачи
  • Репозиторий / Компонент: backend-api (FastAPI Gateway).
  • Контракт метода: POST /api/v1/purchase/upload-receipt.
  • Ссылка на Метод: Конфигурация метода
  • Статус: Готово к реализации
  • Инструкция по шагам:
    1. На Шаге 1: Реализовать прием графического файла (.jpg, .jpeg, .png) в формате Multipart/Form-Data, извлечь параметр локализации app_lang и сгенерировать сквозной UUID в заголовок X-Request-ID (trace_id).
    2. Выполнить синхронную загрузку бинарного тела картинки в S3-хранилище MinIO в выделенный бакет receipt-photos с использованием официального клиента.
    3. На Шаге 2: Сгенерировать и забрать постоянную ссылку доступа image_file_url.
    4. На Шаге 3: Сформировать валидный JSON-пакет (image_file_url, app_lang, x_request_id) и отправить его в Kafka-топик bpds.inventory.in.receipt.image. Вернуть мобильному клиенту ответ HTTP 202 Accepted.